Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions That Modify Movie Properties / Working With Movie Spatial Characteristics

GetTrackDimensions

The GetTrackDimensions function allows your application to determine a track's source, or display, rectangle.

pascal void GetTrackDimensions (Track theTrack, Fixed *width, 
                                 Fixed *height);

theTrack

Specifies the track for this operation. Your application obtains this track identifier from such Movie Toolbox functions as NewMovieTrack and GetMovieTrack (described on page 2-136 and page 2-188, respectively).

width

Contains a pointer to a fixed-point number. The Movie Toolbox returns the width, in pixels, of the track's rectangle. This value corresponds to the x coordinate of the lower-right corner of the track's rectangle.

height

Contains a pointer to a fixed-point number. The Movie Toolbox returns the height, in pixels, of the track's rectangle. This value corresponds to the y coordinate of the lower-right corner of the track's rectangle.

DESCRIPTION

A track's source rectangle defines the coordinate system of the track. You specify the dimensions of the rectangle by providing the coordinates of the lower-right corner of the rectangle. The Movie Toolbox sets the upper-left corner to (0,0) in the track's coordinate system.

ERROR CODES

invalidTrack

-2009

This track is corrupted or invalid

SEE ALSO

You can use the SetTrackDimensions function, which is described in the previous section, to set a track's rectangle.